Recovering CenterScape
If an upgrade fails or the configuration of CenterScape is damaged by users through the user interface or from a flawed configuration import, CenterScape can be recovered by restoring the database from a previous backup. If recovery from a failed upgrade is needed then the previous version of CenterScape will need to be installed after the new version is uninstalled. Note: database connectivity issues and application host server configurations will not be solved by this recovery process as it assumes that databases are operational and accessible
Recovering from a failed upgrade
It is possible that a CenterScape software update could fail. The CenterScape app will report the upgrade failure on the web page as well as errors related to the failure. If RF Code support cannot identify the problem and fix the upgrade the application can be recovered by a database restore from a previous backup as well as reverting back to the previous version of CenterScape.
The following procedure will recover a failed upgrade.
- Stop the CenterScape Service
- Insure that the keystore and system.properties files are backed up and available. If they were not backed up before the upgrade the files can be found in /[install dir]/conf. It is preferred that these files be from ones backed up because the upgrade process can change their contents.
- Uninstall the "new" version of CenterScape
- Restore the CenterScape database from a previous backup. The database should be backed up before upgrading, that backup should be used for the restore.
- Delete any leftover files that the uninstall process left by deleting the CenterScape directory.
- Install the previous version of CenterScape as if it were a new install.
- Stop the CenterScape service once the install is complete
- Copy the system.properties and keystore files that were backed up to the [install dir]/conf directory.
- Start the CenterScape service.
Recovering from a bad configuration
If CenterScape has been configured in such a way that it cannot be recovered to previous function in a timely manner than a previous database backup can be used to reset the app to a configuration that existed prior to the change that cause the problem. This could be a inadvertent remapping of BacNet and Modbus addressing, the deleting of important assets or sensors, or any other error in administration that would be best recovered by reverting to a previous backup.
The following procedure will recover a CenterScape application server by using a previous backup.
- Stop the CenterScape Service
- Restore the database to a previous state before the bad configuration
- Start the CenterScape Service